home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 011 / utildos2.arc / CGCLOCK.DOC < prev    next >
Encoding:
Text File  |  2018-02-16  |  3.5 KB  |  89 lines
  1.  
  2. ;------------------------------------------------------------------------
  3. ; source available from DAN OBRIEN upon request via message on GENE PLANTZ's
  4. ; PC-BBS in CHICAGO, IL.
  5. ;------------------------------------------------------------------------
  6. ; cgclock.asm - real time clock display for color/graphics
  7. ;        display. adapted from clock.asm found on one of
  8. ;        the PC-BBS in Chicago. Allows any color for time
  9. ;        by patching color value using DEBUG. Look for
  10. ;              "Color value of time display="
  11. ;        and set byte follow "=" to BASIC color value.
  12. ;        Currently set to YELLOW (color number is 14 decimal).
  13. ;
  14. ;        Displays time in human form not computer, i.e.,
  15. ;        24 hour military time.
  16. ;
  17. ;        To enable military (24 hour) time display patch
  18. ;        using DEBUG the statement that says
  19. ;                 "Military time=N"
  20. ;        from "N" to "Y".
  21. ;
  22. ;        Also beeps the speaker every quarter hour.
  23. ;
  24. ;        To disable beeping on the quarter hours patch
  25. ;        using DEBUG the statement that says
  26. ;                 "Beep=Y"
  27. ;        from "Y" to "N".
  28. ;
  29. ;        Timer display is refreshed every N tics as defined
  30. ;        by a patchable area using DEBUG. Look for
  31. ;              "Timer tics before time display refresh="
  32. ;        and the value after the "=" is binary 4. Patch to higher or
  33. ;        lower value as you wish to lengthen or shorten interval
  34. ;        between refreshes. Tics occur 18.5 times a second,
  35. ;        and after 4 (default) the display is refreshed with the time.
  36. ;        This keeps overhead of running cgclock to about 4 percent.
  37. ;
  38. ;        To start cgclock just enter "cgclock".
  39. ;        To toggle off and on enter "cgclock" repeatedly.
  40. ;
  41. ;    NOTE:
  42. ;        1. Uses user timer exit int 1Ch for timer display
  43. ;        2. Defines int 60h to toggle time off and on.
  44. ;        3. Displays time without annoying "snow"!
  45. ;            Technique from PC-Tech Journal Premier Issue.
  46. ;        4. Developed under DOS 2.0. Not tested under DOS 1.1
  47. ;            but should work.
  48. ;
  49. ; adapted from clock.asm by DANIEL M. O'BRIEN - 9 July 83 (Version 1.0)
  50. ;
  51. ; 1) meaningful labels added
  52. ; 2) made to work on color/graphics
  53. ; 3) use user timer exit int 1ch instead of 08h directly - slows down
  54. ;    disk drives, also allows BASIC to gain direct control of timer.
  55. ;    And use int 60h instead of 44h (44h defined by DOS 2.0)!
  56. ; 4) allow patching of time display color using DEBUG (Version 1.1)
  57. ; 5) meaningful comments added
  58. ; 6) include salutation
  59. ;
  60. ; DMO - 10 July 83 (Version 1.2)
  61. ; 7) beep on quarter hour and allow patching off
  62. ; 8) 12 hour clock with AM and PM indicator and allow patch for military time
  63. ;
  64. ; DMO - 21 July 83 (Version 1.3)
  65. ; 9) keep counter and update screen only after specified tics count.
  66. ;    currently set to 4 which yields an overhead of about 4 percent.
  67. ;    if set to 1, i.e., update every clock tic, then cgclock has a
  68. ;    overhead of about 20 percent.
  69. ;
  70. ; DMO - 31 July 83 (Version 1.4)
  71. ; 10) move some temporary data areas below init routine for less
  72. ;     resident space requirements.
  73. ;
  74. ; DMO - 12 Sept 83 (Version 1.5)
  75. ; 11) try different algorithm to stuff display into memory to reduce
  76. ;     possible interference with BASIC display to terminal
  77. ; 12) fix bug whereby BX was not being saved and restored when BEEP occured
  78. ; 13) fix bug whereby direction flag not set causing stray characters on
  79. ;     display
  80. ; 14) speedup entry and exit when not time to display
  81. ;
  82. ; FUTURE work
  83. ; 1) date
  84. ; 2) alarm clock
  85. ; 3) any suggestions?
  86. ;---------------------------------------------------------------
  87. 65399 '** DONE - PRESS ENTER TO RETURN TO MENU **
  88. tions?
  89. ;---------------------------------------------------------